home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / gigo0714.zip / MAILLIST.FAQ < prev    next >
Text File  |  1996-07-14  |  9KB  |  207 lines
  1. Q:  How do I host a mailing list?
  2. Q:  Sample of hosting a mailing list
  3.  
  4. A:  [This _only_ applies if you are trying to HOST the mailing list;
  5.      if all you want to do is _translate_ an existing mailing list
  6.      from another site into echomail and vice versa, see the MAPPING
  7.      faq].
  8.  
  9.     Hosting a mailing list is easy with GIGO.  GIGO contains two verbs,
  10.     called CAPTURE (which intercepts messages to certain email addresses,
  11.     newsgroups, and/or echos), and EXPLODE (which sends the captured
  12.     messages to the various recipients).
  13.  
  14.     In addition, you may find LISTSERV to be a valuable tool; that is 
  15.     discussed seperately.  It's main function is to automate 
  16.     subscribe and unsubscribe requests from various users.
  17.  
  18.     The best way to explain how this works, is with a real example of 
  19.     hosting such a mailing list.
  20.  
  21. Problem: 
  22.     You wish to host a mailing list (called "fubar-l") at your site.
  23.     You wish to also have this translated to an echomail conference
  24.     called "FUBAR", as well as to the newsgroup "alt.fubar".
  25.  
  26. Q:  How do I create a .ML file?
  27. Q:  What is a .ML file?
  28.  
  29.     A .ML file is simply an ASCII file, with a list of recipients.
  30.     Each line should have exactly one address on it, and should
  31.     not include the real name or any other extraneous information.
  32.  
  33.     Create a file called "fubar.ml" in your GIGO directory.
  34.     You will want to place one email address per line in this file.
  35.     Ie,
  36.        +-------------------
  37.        |null@wmeonlin.sacbbx.com
  38.        |somebody@somewhere.else.org
  39.        |root@yoursite
  40.        |
  41.     It is probably a good idea to include your regular email address on
  42.     this list, at least at first, to help confirm that everything is 
  43.     working as planned.
  44.  
  45.  
  46.  
  47. Q:  How do I set up addresses for posting news and echomail by email?
  48.  
  49.  +-- Skip these instructions if you have already done this for another
  50.  |   mailing list; they are only needed once for your gateway.
  51.  |
  52.  |  Next, you are going to add a couple of SITE statements in your 
  53.  |  gateway.cfg file.  You may instead wish to INCLUDE MAILLIST.CFG,
  54.  |  and keep your mailing list configuration in this config file instead.
  55.  |  A sample one should be included in the GIGO archives.
  56.  |
  57.  |  Add:
  58.  |    SITE pnews news       ; creates a SITE to post to newsgroups with
  59.  |    SITE pecho echo       ; creates a SITE to post to echomail with
  60.  |
  61.  |  These two SITE statements allow posts to go to places such as
  62.  |  ECHONAME%pecho@yoursite.domain.  You may change "pnews" and "pecho" 
  63.  |  to something else of your choice for security reasons :-) ; these
  64.  |  are just the examples that I am using.  It is suggested that you
  65.  |  do use a different set of names, so that you don't get some twit
  66.  |  hacking via your gateway.
  67.  |_____________________________________________________________________  
  68.  
  69.  
  70. Q:  What is this "badmail.ml" file?
  71. Q:  What are .MLB files?
  72.  
  73.     "BADMAIL.ML" is a file a bit unlinke the other .ml files; this file
  74.     is actually a set of rules that tell GIGO what mail should _not_ be
  75.     re-broadcast in the mailing list.  You would want to tell GIGO 
  76.     that messages from mailer-daemons, etc are not to be resent, as these
  77.     are normally bounce messages that did not go to the bounce address.
  78.  
  79.     Each line in this file should be the token name to look for
  80.     (ie, "From:" or "Subject:"), followed by a space, and then the
  81.     text that defines it as a bad message.  An example file would be:
  82.        +-------------
  83.        |From: daemon
  84.        |From: Mailer-Daemon
  85.        |From: daemon
  86.        |From: DAEMON
  87.        |From: !uucp
  88.        |From: uucp@
  89.        |From: Post Office
  90.        |Subject: Returned mail:  Host
  91.        |
  92.     Any message that has been determined to be bad by the rules defined,
  93.     will be saved as a .MLB (Mailing List - Bad) file instead of a 
  94.     .MLQ file.  You can either delete these messages, or (preferably)
  95.     take a look at them first, and possibly rename it to a .MLQ
  96.     file and let it actually be sent out.
  97.  
  98.  
  99. Q:  How does one CAPTURE messages for a mailing list that I am hosting?
  100.  
  101.     Now, you must tell GIGO what messages to CAPTURE, and where to
  102.     place them.  You will also want to tell GIGO where bounced messages
  103.     from the mailing list should be sent (undoubtedly, someone's address
  104.     who subscribes will not be valid).
  105.  
  106.     Assuming:
  107.       you want to use the "fubar\" subdirectory
  108.       you want error messages to be sent to "fubar-owner@yoursite.etc"
  109.       you want _email_ to  fubar-l captured
  110.       you want _news_  in "alt.fubar" captured
  111.       you want _echomail_ from "FUBAR" captured
  112.       you have a defination of "bad mail" in badmail.ml
  113.       you want to name the mailing list "The Fubar Debate"
  114.  
  115.     you will want to create the following CAPTURE line:
  116.  
  117.     CAPTURE fubar\ fubar-l fubar-owner alt.fubar FUBAR badmail.ml The Fubar Debate
  118.  
  119. Q:  What if I want to host a private mailing list, where only the 
  120.     members on the list can post?
  121.  
  122.     [07-14-96]  That's now fairly easy.  
  123.  
  124.     CAPTUREPRIV fubar.ml fubar\ fubar-l fubar-owner alt.fubar FUBAR badmail.ml The Fubar Debate
  125.  
  126.     Use CAPTUREPRIV instead of CAPTURE - and specfy (up front) the .ML file
  127.     that contains the list of subscribers to use. Only those people
  128.     who are listed in the .ML file are going to have thier messages
  129.     CAPTURED.
  130.  
  131.     You will want to *also* have a regular "CAPTURE" statement
  132.     with a different holding directory, so that when someone posts a 
  133.     message (if not a member), you can manaully approve and move it 
  134.     to the correct directory.  Note that the order will be important!
  135.     This example will place all such messages into the hold\ directory.
  136.  
  137.     CAPTUREPRIV fubar.ml fubar\ fubar-l fubar-owner alt.fubar FUBAR badmail.ml The Fubar Debate
  138.     CAPTURE hold\ fubar-l fubar-owner alt.fubar FUBAR badmail.ml The Fubar Debate
  139.  
  140.     Alternately, you can define a USER statement to do something
  141.     such as bounce the message back (ie, they are not supposed to
  142.     post).  This example will send back "BOUNCE.TXT" to them.
  143.  
  144.     CAPTUREPRIV fubar.ml fubar\ fubar-l fubar-owner alt.fubar FUBAR badmail.ml The Fubar Debate
  145.     USER fubar-l BOUNCE bounce.txt
  146.  
  147.  
  148. Q:  What is a .MLQ file?
  149.  
  150.     Once this is defined, any messages sent in any of the three mediums
  151.     will be captured, and placed into the fubar\ directory as a *.MLQ
  152.     file (MLQ stands for Mailing List Queue).  It is a plain ASCII 
  153.     text file, with the first line of that text file being a Ctrl-A
  154.     followed by "ECHO", "NEWS", or the email address of the person 
  155.     that posted the message.  This information is used by EXPLODE so that
  156.     the message is not sent back to the same place the message originally
  157.     came from.
  158.  
  159.     Note that you may have multiple CAPTURE lines, even pointing to the
  160.     same directory (ie, if you have multiple incoming email addresses).
  161.     Only the first applicable CAPTURE statement for a given message will be 
  162.     used.
  163.  
  164.  
  165.  
  166. Q:  How do I send out the .MLQ files that were CAPTURED
  167.  
  168.     Now that you have these captured messages, you are going to need to send 
  169.     them out to the various recipients.
  170.  
  171.     Assuming that you created "SITE pnews news" and "SITE pecho echo",
  172.     and assuming that we are following up on the previous example 
  173.     for the FUBAR mailing list:
  174.  
  175.     EXPLODE fubar\ fubar.ml fubar-owner alt.fubar@pnews.mysite.org FUBAR@pecho.mysite.org
  176.  
  177. [Quoted from MAILLIST.CFG]
  178.  
  179.  ;  Whenever GIGO runs, if there are any EXPLODE statements in the config
  180.  ;  file, GIGO will look at the specified files for *.MLQ files.  If
  181.  ;  it finds any, it will process those files, and rename them to
  182.  ;  *.MLS files (Mailing List Sent).  You may either do further processing
  183.  ;  on them, or simply delete them - that is up to you.  The author
  184.  ;  saves them in an archive for later use.
  185.  ;
  186.  ;  When GIGO finds a MLQ file to be sent out, it will take a look at the
  187.  ;  first line of the file.  If it starts with Ctrl-A (""), it will
  188.  ;  assume that that first line contains the phrase "NEWS